GET
/
files
/
{id}
/
presignedurl
/
contents
Retrieve contents of file
curl --request GET \
  --url https://{subdomain}.storage.{region}.nhost.run/v1/files/{id}/presignedurl/contents \
  --header 'Authorization: Bearer <token>'
This response does not have an example.

Authorizations

​
Authorization
string
header
required

API key to authorize requests.

Headers

​
if-match
string

Only return the file if the current ETag matches one of the values provided

​
if-none-match
string

Only return the file if the current ETag does not match any of the values provided

​
if-modified-since
string

Only return the file if it has been modified after the given date

Example:

"Tue, 12 Aug 2025 12:03:50 GMT"

​
if-unmodified-since
string

Only return the file if it has not been modified after the given date

Example:

"Tue, 12 Aug 2025 12:03:50 GMT"

​
Range
string

Range of bytes to retrieve from the file. Format: bytes=start-end

Path Parameters

​
id
string
required

Unique identifier of the file

Query Parameters

​
X-Amz-Algorithm
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Credential
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Date
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Expires
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Signature
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-SignedHeaders
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Checksum-Mode
string
required

Use presignedurl endpoint to generate this automatically

​
X-Amz-Security-Token
string

Use presignedurl endpoint to generate this automatically

​
x-id
string
required

Use presignedurl endpoint to generate this automatically

​
q
integer

Image quality (1-100). Only applies to JPEG, WebP and PNG files

Required range: 1 <= x <= 100
​
h
integer

Maximum height to resize image to while maintaining aspect ratio. Only applies to image files

Required range: x >= 1
​
w
integer

Maximum width to resize image to while maintaining aspect ratio. Only applies to image files

Required range: x >= 1
​
b
number

Blur the image using this sigma value. Only applies to image files

Required range: x >= 0
​
f
enum<string>
default:same

Output format for image files. Use 'auto' for content negotiation based on Accept header

Available options:
auto,
same,
jpeg,
webp,
png,
avif
Example:

"same"

Response

File content retrieved successfully

The response is of type file.